home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / fsmount / fsmount.man < prev    next >
Encoding:
Text File  |  1992-02-06  |  4.1 KB  |  109 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/admin/fsmount/RCS/fsmount.man,v 1.2 92/02/06 12:04:45 voelker Exp Locker: voelker $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS FSMOUNT cmds
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. fsmount \- Check disks and export prefixes 
  17. .SH SYNOPSIS
  18. \fBfsmount\fR [\fIoptions\fR]
  19. .SH OPTIONS
  20. .IP "\fB\-W\fR" 15
  21. Check disks, but do not write changes.
  22. .IP "\fB\-f\fR" 15
  23. Don't check disks (fastboot).
  24. .IP "\fB\-v\fR" 15
  25. Have both \fBfsmount\fR and \fBfscheck\fR  output verbose information
  26. while running (the default).
  27. .IP "\fB\-n\fR" 15
  28. Don't attach disks or export prefixes.
  29. .IP "\fB\-p\fR" 15
  30. Print out actions but don't execute them.
  31. .IP "\fB\-help\fR" 15
  32. Print a summary of the command-line options and exit.
  33. .IP "\fB\-d \fIdeviceDirectory\fR" 15
  34. Specifies the directory containing the device files.
  35. The default is "/dev/".
  36. .IP "\fB\-i \fIspriteID\fR" 15
  37. Causes prefixes that this machine will export to be preloaded into the
  38. prefix table with \fIspriteID\fR as the server. 
  39. This prevents the machine from broadcasting for its own prefixes while
  40. the disks are being checked.
  41. .IP "\fB\-fscheck \fIfscheckProg\fR" 15
  42. Use this to specify an alternative fscheck program, i.e., when testing
  43. a new fscheck.
  44. .IP "\fB\-c\fR" 15
  45. Conditionally check the disks.  If the disks were just checked by \fIfscheck\fR
  46. and we are now rebooting, then we don't have to check again.  If the \fB\-c\fR
  47. flag is present then the disks won't be rechecked. 
  48. .BE
  49.  
  50. .SH DESCRIPTION
  51. .PP
  52. \fBFsmount\fR is used during system boot to check the disks for 
  53. inconsistencies and
  54. to export prefixes.
  55. It is a replacement for \fBfsattach\fR, and is intented to be used without
  56. a mount table.  It uses \fBfsinfo\fR to determine what filesystems are
  57. on the disks connected to the host, \fBfscheck\fR to check the filesystems
  58. found (if they are OFS), and \fBprefix\fR to mount and export them.
  59. In this way, disks can change hosts, change prefixes, or change
  60. parititioning without having to update a mount table file.
  61. .PP
  62. \fBFsmount\fR does some checking before it \fBprefix\fRes filesystems.  If
  63. it finds filesystems whose cylinder extents overlap, it will only
  64. \fBprefix\fR the larger of the filesystems.  If more than one
  65. filesystem has the same prefix, it will try to mount those filesystems
  66. until one successfully mounts and it will ignore the remainder.  If a
  67. filesystem has a prefix of a filesystem already in the prefix table,
  68. it is ignored.
  69. .PP
  70. Currently, \fBfsmount\fR detects and notes root partitions, but does
  71. not try to either check or mount them.
  72. .PP
  73. Upon completion, \fBfsmount\fR creates a \fBfsmounted\fR file in
  74. \fB/hosts/$HOST/fsmounted\fR reporting the filesystems it mounted
  75. and exported, and when it did so.
  76.  
  77. .SH RETURN CODES
  78. \fBFsmount\fR returns the same error codes as \fBfsattach\fR:
  79. .IP 0
  80. No error.
  81. .IP 1
  82. An error was found in the root partition. Reboot the system. See \fBfscheck\fR
  83. for details.
  84. .IP 2
  85. A hard error occurred. There was some problem in either \fBfsattach\fR, 
  86. \fBfscheck\fR,
  87. or \fBprefix\fR that prevented \fBfsattach\fR from completing normally.
  88. .IP 3 
  89. \fBFscheck\fR returned a soft error indication. See \fBfscheck\fR for details.
  90. .IP 4
  91. An error was found in the root partition, but the number of consecutive
  92. times that \fBfscheck\fR was run and an error found exceeds the limit.
  93. .KS
  94. .SH FILES
  95. .DS L
  96. .nf
  97. /boot/cmds/fsinfo            command to list filesystems on disk
  98. /boot/cmds/fscheck            command to check disks
  99. /hosts/$HOST/*.fsc            output from fscheck
  100. /bootTmp/.fscheck.out        temporary output from fscheck
  101. /boot/cmds/prefix            command to mount and export filesystems
  102. /hosts/$HOST/fsmounted        report file for fsmount
  103. .DE
  104. .KE
  105. .fi
  106. .SH KEYWORDS
  107. fsmount, fscheck, prefix, fsinfo, fsdomain, mount, disk, partition, crash, attach, boot 
  108.  
  109.